---
type: integration
title: '@astrojs/vercel'
description: "Apprenez à utiliser l'adaptateur SSR @astrojs/vercel pour déployer votre projet Astro."
githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/integrations/vercel/'
category: adapter
i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import ReadMore from '~/components/ReadMore.astro';
import Since from '~/components/Since.astro'

Cet adaptateur permet à Astro de déployer votre [site rendu `hybrid` ou `server`](/fr/basics/rendering-modes/#rendu-à-la-demande) sur [Vercel](https://www.vercel.com/).

Si vous utilisez Astro comme [constructeur de site `statique`](/fr/basics/rendering-modes/#pré-rendu), vous n'avez besoin de cet adaptateur que si vous utilisez des services Vercel supplémentaires (par exemple [Vercel Web Analytics](https://vercel.com/docs/analytics), [Vercel Image Optimization](https://vercel.com/docs/image-optimization)). Sinon, vous n'avez pas besoin d'adaptateur pour déployer votre site `statique`.

Apprenez à déployer votre site Astro dans notre [Guide de déploiement Vercel](/fr/guides/deploy/vercel/).

## Pourquoi Astro Vercel ?

[Vercel](https://www.vercel.com/) est une plateforme de déploiement qui vous permet d'héberger votre site en vous connectant directement à votre dépôt GitHub. Cet adaptateur améliore le processus de construction d'Astro pour préparer votre projet à être déployé via Vercel.

## Installation

Astro inclut une commande `astro add` pour automatiser l'installation des intégrations officielles. Si vous préférez, vous pouvez [installer les intégrations manuellement](#installation-manuelle) à la place.

Ajoutez l'adaptateur Vercel pour activer SSR dans votre projet Astro avec la commande `astro add` suivante. Cela installera `@astrojs/vercel` et apportera les changements appropriés à votre fichier `astro.config.mjs` en une seule étape.

<PackageManagerTabs>
  <Fragment slot="npm">
    ```sh
    npx astro add vercel
    ```
  </Fragment>
  <Fragment slot="pnpm">
    ```sh
    pnpm astro add vercel
    ```
  </Fragment>
  <Fragment slot="yarn">
    ```sh
    yarn astro add vercel
    ```
  </Fragment>
</PackageManagerTabs>

### Installation manuelle

Tout d'abord, ajoutez l'adaptateur `@astrojs/vercel` aux dépendances de votre projet en utilisant votre gestionnaire de paquets préféré :

<PackageManagerTabs>
  <Fragment slot="npm">
    ```sh
    npm install @astrojs/vercel
    ```
  </Fragment>
  <Fragment slot="pnpm">
    ```sh
    pnpm add @astrojs/vercel
    ```
  </Fragment>
  <Fragment slot="yarn">
    ```sh
    yarn add @astrojs/vercel
    ```
  </Fragment>
</PackageManagerTabs>

Ensuite, ajoutez l'adaptateur et votre [mode de rendu à la demande](/fr/basics/rendering-modes/#rendu-à-la-demande) à votre fichier `astro.config.*` :

```js title="astro.config.mjs" ins={2, 6-7}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel(),
});
```

### Choix d'une méthode de déploiement

Vous pouvez vous déployer vers différentes cibles :

* `serverless` : SSR à l'intérieur d'une [fonction Node.js](https://vercel.com/docs/concepts/functions/serverless-functions).
* `static` : génère un site web statique en suivant les formats de sortie de Vercel, les redirections, etc.

Vous pouvez changer la cible en changeant l'importation :

```js "serverless" "static"
import vercel from '@astrojs/vercel/serverless';
import vercel from '@astrojs/vercel/static';
```

## Utilisation

<ReadMore>En savoir plus sur [le déploiement de votre projet sur Vercel](/fr/guides/deploy/vercel/)</ReadMore>

Vous pouvez déployer par CLI (`vercel deploy`) ou en connectant votre nouveau repo dans le [Vercel Dashboard](https://vercel.com/). Vous pouvez également créer une version de production localement :

```sh
astro build
vercel deploy --prebuilt
```

## Configuration

Pour configurer cet adaptateur, passez un objet à l'appel de la fonction `vercel()` dans `astro.config.mjs` :

### `webAnalytics`

**Type:** `VercelWebAnalyticsConfig`<br/>
**Disponible pour:** Serverless, Static<br/>
<Since v="3.8.0" pkg="@astrojs/vercel" />

Vous pouvez activer [Vercel Web Analytics](https://vercel.com/docs/concepts/analytics) en définissant `webAnalytics : { enabled : true }`. Cela injectera les scripts de suivi de Vercel dans toutes vos pages.

```js title="astro.config.mjs" ins={8-10}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    webAnalytics: {
      enabled: true,
    },
  }),
});
```

### `imagesConfig`

**Type :** `VercelImageConfig`<br/>
**Disponible pour :** Serverless, Static
<Since v="3.3.0" pkg="@astrojs/vercel" />

Options de configuration pour [Image Optimization API de Vercel](https://vercel.com/docs/concepts/image-optimization). Voir [la documentation sur la configuration des images de Vercel](https://vercel.com/docs/build-output-api/v3/configuration#images) pour une liste complète des paramètres pris en charge.

Les propriétés `domains` et `remotePatterns` seront automatiquement remplies en utilisant [les paramètres `image` correspondants d'Astro](/fr/reference/configuration-reference/#image-options).

```js title="astro.config.mjs" ins={8-10}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/static';

export default defineConfig({
  // ...
  output: 'static',
  adapter: vercel({
    imagesConfig: {
      sizes: [320, 640, 1280],
    },
  }),
});
```

### `imageService`

**Type :** `boolean`<br/>
**Disponible pour :** Serverless, Static
<Since v="3.3.0" pkg="@astrojs/vercel" />

Lorsque cette option est activée, un [Service d'images](/fr/reference/image-service-reference/) alimenté par l'API Vercel Image Optimization sera automatiquement configuré et utilisé en production. En développement, le service d'image spécifié par [`devImageService`](#devimageservice) sera utilisé à la place.

```js title="astro.config.mjs" ins={8}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/static';

export default defineConfig({
  // ...
  output: 'static',
  adapter: vercel({
    imageService: true,
  }),
});
```

```astro title="src/pages/index.astro"
---
import { Image } from 'astro:assets';
import astroLogo from '../assets/logo.png';
---

<!-- This component -->
<Image src={astroLogo} alt="Mon super logo !" />

<!-- deviendra le HTML suivant -->
<img
  src="/_vercel/image?url=_astro/logo.hash.png&w=...&q=..."
  alt="Mon super logo !"
  loading="lazy"
  decoding="async"
  width="..."
  height="..."
/>
```

### `devImageService`

**Type :** `'sharp' | 'squoosh' | string`<br/>
**Disponible pour :** Serverless, Static
<Since v="3.8.0" pkg="@astrojs/vercel" />
**Défaut :** `sharp`

Permet de configurer le service d'images à utiliser pour le développement lorsque [imageService](#imageservice) est activé. Cela peut être utile si vous ne pouvez pas installer les dépendances de Sharp sur votre machine de développement, mais que l'utilisation d'un autre service d'image comme Squoosh vous permet de prévisualiser les images dans votre environnement de développement. La construction n'est pas affectée et utilisera toujours l'optimisation d'image de Vercel.

Il peut également être défini à une valeur arbitraire afin d'utiliser un service d'images personnalisé au lieu des services intégrés d'Astro.

```js title="astro.config.mjs" ins={8-9}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    imageService: true,
    devImageService: 'squoosh',
  }),
});
```

### `isr`

**Type :** <code>boolean | VercelISRConfig</code><br/>
**Disponible pour :** Serverless
<Since v="7.2.0" pkg="@astrojs/vercel" />
**Défaut :** `false`

Permet à votre projet d'être déployé en tant que fonction [ISR (Incremental Static Regeneration)](https://vercel.com/docs/incremental-static-regeneration), qui met en cache vos pages rendues à la demande de la même manière que les pages pré-rendues après la première demande.

Pour activer cette fonctionnalité, mettez `isr` à true dans la configuration de votre adaptateur Astro dans `astro.config.mjs` :

```js title="astro.config.mjs" ins={8}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    isr: true,
  }),
});
```

Notez que les demandes de fonctions de l'ISR ne comprennent pas de paramètres de recherche, comme [requests](/fr/reference/api-reference/#astrorequest) en mode statique.

#### Invalidation du cache de l'ISR

Par défaut, une fonction ISR est mise en cache pour la durée de votre déploiement. Vous pouvez contrôler davantage la mise en cache en définissant un délai d'expiration ou en excluant complètement certains itinéraires de la mise en cache.

##### Invalidation basée sur le temps

Vous pouvez modifier la durée de mise en cache des routes en configurant une valeur `expiration` en secondes :

```js title="astro.config.mjs" {8-11}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    isr: {
      // met en cache toutes les pages à la première demande et les sauvegarde pendant 1 jour
      expiration: 60 * 60 * 24,
    },
  }),
});
```

##### Exclusion des chemins d'accès de la mise en cache

Pour mettre en œuvre le [Mode brouillon](https://vercel.com/docs/build-output-api/v3/features#draft-mode) ou la [Régénération statique incrémentale (RSI) à la demande](https://vercel.com/docs/build-output-api/v3/features#on-demand-incremental-static-regeneration-isr) de Vercel, vous pouvez créer un jeton de contournement et le fournir à la configuration `isr` avec toutes les routes à exclure de la mise en cache :

```js title="astro.config.mjs" {7-12}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
    output: "server",
    adapter: vercel({
        isr: {
            // Une chaîne aléatoire secrète que vous créez.
            bypassToken: "005556d774a8",
            // Des chemins qui seront toujours fraîchement servis.
            exclude: [ "/api/invalidate", "/posts/[...slug]" ]
        }
    })
})
```

### `includeFiles`

**Type :** `string[]`<br/>
**Disponible pour :** Serverless

Utilisez cette propriété pour forcer l'intégration de fichiers dans votre fonction. C'est utile lorsque vous remarquez qu'il manque des fichiers.

```js title="astro.config.mjs" ins={8}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    includeFiles: ['./my-data.json'],
  }),
});
```

### `excludeFiles`

**Type :** `string[]`<br/>
**Disponible pour :** Serverless

Utilisez cette propriété pour exclure du processus de regroupement des fichiers qui seraient autrement inclus.

```js title="astro.config.mjs" ins={8}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    excludeFiles: ['./src/some_big_file.jpg'],
  }),
});
```

### `maxDuration`

**Type :** `number`<br/>
**Disponible pour :** Serverless

Utilisez cette propriété pour étendre ou limiter la durée maximale (en secondes) que les fonctions Serverless peuvent exécuter avant de s'arrêter. Voir la [documentation Vercel](https://vercel.com/docs/functions/serverless-functions/runtimes#maxduration) pour la limite par défaut et la limite maximale pour votre plan de compte.

```js title="astro.config.mjs" ins={8}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
// ...
  output: "server",
  adapter: vercel({
    maxDuration: 60
  }),
});
```

### Configuration du regroupement des fonctions

L'adaptateur Vercel combine toutes vos routes en une seule fonction par défaut.

Vous avez également la possibilité de diviser les constructions en une fonction séparée pour chaque route en utilisant l'option `functionPerRoute`. Cela réduit la taille de chaque fonction, ce qui signifie que vous êtes moins susceptible de dépasser la limite de taille pour une fonction individuelle. De plus, les démarrages de code sont plus rapides.

Vérifiez que votre plan Vercel comprend un nombre approprié de fonctions avant d'activer l'option `functionPerRoute`. Par exemple, le niveau gratuit de Vercel limite chaque déploiement à un maximum de 12 fonctions. Si votre plan Vercel est insuffisant pour le nombre de routes de votre projet, vous recevrez un message d'erreur pendant le déploiement.

```js title="astro.config.mjs" ins={8}
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    functionPerRoute: true,
  }),
});
```

### Le middleware Vercel Edge avec le middleware Astro

L’adaptateur @astrojs/vercel/serverless peut créer une [fonction edge] (https://vercel.com/docs/functions/edge-functions) à partir d’un middleware Astro dans votre base de code. Lorsque ‘edgeMiddleware’ est activé, une fonction edge exécute votre code middleware pour toutes les demandes, y compris les ressources statiques, les pages pré-rendues et les pages rendues à la demande.

Pour les pages rendues à la demande, l'objet `context.locals` est sérialisé en utilisant du JSON et envoyé dans un en-tête pour la fonction serverless, qui effectue le rendu. Comme mesure de sécurité, la fonction serverless refusera de servir les requêtes avec une réponse `403 Forbidden` à moins qu'elles ne proviennent de la fonction edge générée.

Il s'agit d'une fonctionnalité opt-in, et l'option `edgeMiddleware` doit être positionnée à `true` :

```js title="astro.config.mjs" "edgeMiddleware: true"
import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  // ...
  output: 'server',
  adapter: vercel({
    edgeMiddleware: true,
  }),
});
```

L'Edge Middleware a accès au [`RequestContext`](https://vercel.com/docs/functions/edge-middleware/middleware-api#requestcontext) de Vercel avec `ctx.locals.vercel.edge`. Si vous utilisez TypeScript, vous pouvez obtenir les typages appropriés en mettant à jour `src/env.d.ts` pour utiliser `EdgeLocals` :

```ts
/// <reference path="../.astro/types.d.ts" />
/// <reference types="astro/client" />

type EdgeLocals = import('@astrojs/vercel').EdgeLocals

declare namespace App {
  interface Locals extends EdgeLocals {
    // ...
  }
}
```

### Support des versions de Node.js

L'adaptateur `@astrojs/vercel` supporte des versions spécifiques de Node.js pour déployer votre projet Astro sur Vercel. Pour voir les versions de Node.js supportées sur Vercel, cliquez sur l'onglet des paramètres d'un projet et descendez jusqu'à la section "Node.js Version".

Consultez la [documentation Vercel](https://vercel.com/docs/functions/serverless-functions/runtimes/node-js#default-and-available-versions) pour en savoir plus.


[astro-integration]: /fr/guides/integrations-guide/
